#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
# @Date : 2024/4/17 13:44
# @Author : water
# @Description : 错误异常

"""
错误和异常
    作为 Python 初学者，在刚学习 Python 编程时，经常会看到一些报错信息，在前面我们没有提及，这章节我们会专门介绍。
    Python 有两种错误很容易辨认：语法错误和异常。
    Python assert（断言）用于判断一个表达式，在表达式条件为 false 的时候触发异常。
    ASSERT RAISE
    try except else finally
    语法错误
        Python 的语法错误或者称之为解析错，是初学者经常碰到的
    异常
        即便 Python 程序的语法是正确的，在运行它的时候，也有可能发生错误。运行期检测到的错误被称为异常。
        大多数的异常都不会被程序处理，都以错误信息的形式展现在这里:
异常处理
    try/except
        异常捕捉可以使用 try/except 语句。
            try：
                执行代码
            except:
                发生异常时执行的代码

        一个 try 语句可能包含多个except子句，分别来处理不同的特定的异常。最多只有一个分支会被执行。
        处理程序将只针对对应的 try 子句中的异常进行处理，而不是其他的 try 的处理程序中的异常。
        一个except子句可以同时处理多个异常，这些异常将被放在一个括号里成为一个元组，例如:
            except (RuntimeError, TypeError, NameError):
                pass
        最后一个except子句可以忽略异常的名称，它将被当作通配符使用。你可以使用这种方法打印一个错误信息，然后再次把异常抛出。

    try/except...else
        try/except 语句还有一个可选的 else 子句，如果使用这个子句，那么必须放在所有的 except 子句之后。
        else 子句将在 try 子句没有发生任何异常的时候执行。
        try:
            执行代码
        except:
            发生异常时执行的代码
        else:
            没有异常时执行的代码

        使用 else 子句比把所有的语句都放在 try 子句里面要好，这样可以避免一些意想不到，而 except 又无法捕获的异常。
        异常处理并不仅仅处`理那些直接发生在 try 子句中的异常，而且还能处理子句中调用的函数（甚至间接调用的函数）里抛出的异常

    try-finally 语句
        try-finally 语句无论是否发生异常都将执行最后的代码。
        try:
            执行代码
        except:
            发生异常时执行的代码
        else:
            没有异常时执行的代码
        finally:
            不管有没有异常都会执行的代码
抛出异常
    Python 使用 raise 语句抛出一个指定的异常。
    raise语法格式如下：
        raise [Exception [, args [, traceback]]]

    raise 唯一的一个参数指定了要被抛出的异常。它必须是一个异常的实例或者是异常的类（也就是 Exception 的子类）。
    如果你只想知道这是否抛出了一个异常，并不想去处理它，那么一个简单的 raise 语句就可以再次把它抛出。

用户自定义异常
    你可以通过创建一个新的异常类来拥有自己的异常。异常类继承自 Exception 类，可以直接继承，或者间接继承
基础类：
    当创建一个模块有可能抛出多种不同的异常时，一种通常的做法是为这个包建立一个基础异常类，然后基于这个基础类为不同的错误情况创建不同的子类:
定义清理行为
    try 语句还有另外一个可选的子句，它定义了无论在任何情况下都会执行的清理行为
        try:
             raise KeyboardInterrupt
        finally:
             print('Goodbye, world!')
预定义的清理行为
    一些对象定义了标准的清理行为，无论系统是否成功的使用了它，一旦不需要它了，那么这个标准的清理行为就会执行。
"""

# 异常处理（try/except）
while True:
    try:
        x = int(input("请输入一个数字: "))
        break
    except ValueError:
        print("您输入的不是数字，请再次尝试输入！")

# 多个异常

import sys

try:
    f = open('myfile.txt')
    # f = open('foo.txt')
    s = f.readline()
    i = int(s.strip())
except OSError as err:
    print("OS error: {0}".format(err))
except ValueError:
    print("Could not convert data to an integer.")
except:
    print("Unexpected error:", sys.exc_info()[0])
    raise

# 异常处理：try/except...else
print(sys.argv)
for arg in sys.argv[1:]:
    try:
        f = open(arg, 'r')
    except IOError:
        print('cannot open', arg)
    else:
        print(arg, 'has', len(f.readlines()), 'lines')
        f.close()


# try-finally 语句

def runoob():
    pass


try:
    runoob()
except AssertionError as error:
    print(error)
else:
    try:
        with open('file.log') as file:
            read_data = file.read()
    except FileNotFoundError as fnf_error:
        print(fnf_error)
finally:
    print('这句话，无论异常是否发生都会执行。')

# raise 抛出异常

x = 10
if x > 5:
    # raise Exception('x 不能大于 5。x 的值为: {}'.format(x))
    pass


#  二次抛出异常
def throw_exception():
    try:
        raise NameError('HiThere')
    except NameError:
        print('An exception flew by!')
        raise


# throw_exception()

# 用户自定义异常
class MyError(Exception):
    """My own exception class
    Attributes:
        msg  -- explanation of the error
    """

    def __init__(self, msg):
        """
        类 Exception 默认的 __init__() 被覆盖。
        """
        self.msg = msg


def revoke_exception():
    try:
        raise MyError(2 * 2)
    except MyError as e:
        print('My exception occurred, value:', e.msg)


# 基础类：大多数的异常的名字都以"Error"结尾，就跟标准的异常命名一样。

class Error(Exception):
    """Base class for exceptions in this module."""
    pass


class InputError(Error):
    """Exception raised for errors in the input.

    Attributes:
        expression -- input expression in which the error occurred
        message -- explanation of the error
    """

    def __init__(self, expression, message):
        self.expression = expression
        self.message = message


class TransitionError(Error):
    """Raised when an operation attempts a state transition that's not
    allowed.

    Attributes:
        previous -- state at beginning of transition
        next -- attempted new state
        message -- explanation of why the specific transition is not allowed
    """

    def __init__(self, previous, next, message):
        self.previous = previous
        self.next = next
        self.message = message

    def divide(x, y):
        try:
            result = x / y
        except ZeroDivisionError:
            print("division by zero!")
        else:
            print("result is", result)
        finally:
            print("executing finally clause")


TransitionError.divide(2, 3)

# 关键词 with 语句就可以保证诸如文件之类的对象在使用完之后一定会正确的执行他的清理方法:

# 这段代码执行完毕后，就算在处理过程中出问题了，文件 f 总是会关闭。
with open("myfile.txt") as f:
    for line in f:
        print(line, end="")

# 这个没有关闭资源
for line in open("myfile.txt"):
    print(line, end="")
